<?php

/**
 * @OA\Get(
 *   path="/sanctum/csrf-cookie",
 *   summary="CSRF保护",
 *   description="在登录前请求，且没有`/api`前缀（这是 sanctum 的初始特性）。但为了统一接口 url 的 prefix，我们需要修改 sanctum 的 prefix，即在 sanctum 的配置文件中添加一个 prefix='api/sanctum' 即可。"
 *   operationId="csrf-cookie",
 *   tags={"authenticate"},
 *   @OA\Response(response=204, description="No Content")
 * )
 */

/**
 * @OA\Post(
 *   path="/login",
 *   summary="登录",
 *   operationId="login",
 *   tags={"authenticate"},
 *   @OA\Parameter(name="username", in="query", required=true, description="用户名", @OA\Schema(type="string", default="zhangpipi.o3o@gmail.com")),
 *   @OA\Parameter(name="password", in="query", required=true, description="密码", @OA\Schema(type="string", default="password")),
 *   @OA\Response(response=200, description="OK",
 *     @OA\JsonContent(type="object",
 *       @OA\Property(property="data", ref="#/components/schemas/Login")
 *     )
 *   ),
 *   @OA\Response(response=422, description="Unprocessable Entity")
 * )
 */

/**
 * @OA\Schema(
 *   schema="Login",
 *   @OA\Property(property="access_token", type="string", description="令牌"),
 *   @OA\Property(property="token_type", type="string", description="令牌类型")
 * )
 */
